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Preface 


Link Level Access for the H P 9000 (LLA/9000) is a Hewlett-Packard data 
communications and data management product supported on earlier 
HP-UX releases. The Data Link Provider I nterface (DLPI) is an industry 
standard which defines a STREAM S-based interface to the Logical Link 
Control (LLC) 802.3 services. 

The LLA to DLPI M igration Guideprovides information about migrating 
LLA programs to DLPI programs. 

This manual is organized as follows: 

Chapter 1 LLA to DLPI Migration provides information about 

migrating programs from the H P proprietary LLA to 
the industry standard DLPI. 

Chapter 2 LLA and DLPI Example Programs includes 

example programs that compare LLA and DLPI. 
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LLAtoDLPI Migration 



LLA to DLPI Migration 


As part of Hewlett-Packard’s movement toward industry standard 
networking, H P has discontinued the LLA/9000 product with the H P-UX 
10.30 release. HP recommends that you migrate all existing applications 
that use LLA to the industry standard Data Link Provider I nterface 
(DLPI). HP provides DLPI with the LAN/9000 product. 

Before you begin the process of migrating your application, you may need 
to review the DLPI Programmer's Guide. 

The following information explains the basic differences between LLA 
and DLPI. This information is the basis for performing migration. 
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LLA to DLPI Migration 

Device Files 


Device Files 

Device files are used to identify the LAN driver, Ethernet/IEEE 802.3 
interface card, and protocol to be used. Each LAN driver/interface card 
and protocol combination (Ethernet or IEEE 802.3) is associated with a 
device file. 

A network device file is I ike any other HP-UX device file. When you write 
to a network device file after opening it, the data goes out on the 
network, just as when you write to a disk drive device file, the data goes 
out onto the disk. 

By convention, device files are kept in a directory called /dev. When the 
LAN/9000 product is installed, several special device files are created. 
Among these files are the network device files associated with the LAN 
interface. If default names are used during installation, these files are 
called /dev/ianO and /dev/etherO for IEEE 802.3 and Ethernet, 
respectively. 

LLA requires a separate device file for every LAN interface in the 
system. This device file is used by LLA to uniquely identify a specific 
device (e.g. /dev/ianO). 

DLPI only requires one device file (/dev/dipi) to access all supported 
LAN interfaces. In addition, there are other device files (/dev/dipix, 
where x is 0-100), used by DLPI, to access all supported LAN interfaces. 
The difference between /dev/dipi and /dev/dipix is clone vs. 
non-cloneable devices. Basically, cloneable devices give you a separate 
stream for each open request. 

Non-cloneable devices only give you one stream no matter how many 
times you open the device. All of the LAN interfaces supported by H P 
DLPI support both cloneable and non-cloneable access. 


Chapter 1 
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ioctl Requests 


Table 1-1 


ioctl Requests 

All general control requests (i.e. protocol logging, destination addresses, 
multicast addresses, etc.) for LLA are issued via the ioctl system call. 

The HP-UX ioctl call is used to construct, inspect, and control the 
network environment in which an LLA application will operate. All LLA 
applications must usethe ioctl call to configure source and destination 
addresses before data can be sent or received using the H P-UX read and 
write calls. 

ioctl requests are used i n DLPI onlyfor device specific control 
requests. These ioctl requests are not interpreted by DLPI, but passed 
directly to the driver for processing. All general control requests in DLPI 
are defined with a standard DLPI 2.0 primitive or extension. These 
primitives are passed to DLPI via the putmsg system call only. 

All of the standard DLPI primitives are defined in <sys/dipi. h>. The 
DLPI Programmer's Guide provides detailed descriptions of all the 
primitives. All HP DLPI extensions (denoted in the following table with 
an *) are defined in <sys/dipi_ext .h>. 

Table 1-1 lists LLA ioctl request types and their corresponding DLPI 
primitives. 


LLA ioctlsand Corresponding DLPI Primitives 


LLA ioctl (req type) 

DLPI Primitive 

LOG_TYPE_FI ELD 

DL BIND REQ or 

DL_SUBS_BI ND_REQ 

LOG_SSAP 

DL BIND REQ or 

DL_SUBS_BI ND_REQ 

LOG_DSAP 

Not required with DLPI. The destination 
address is specified with each data 
request (seeTransmitting data). 

LOG_DEST_ADDR 

Not required with DLPI. The destination 
address is specified with each data 
request (seeTransmitting data). 

LOG_READ_CACHE 

Not defined 
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LLA ioctl (req type) 

DLPI Primitive 

LOG_READ_TI MEOUT 

Not defined 

LLA_SIGNAL_MASK 

Not defined 

FRAME_HEADER 

Frame headers are delivered with each 
individual packet via the control portion 
of the message. 

LOCAL_ADDRESS 

DL_PHYS_ADDR_REQ 

DEVI CE_STATUS 

DL_H P_H W_STATUS_REQ* 

MULTICAST_ADDRESSES 

DL_H P_M U LTI CAST_L 1 ST_R E Q* 

MULTICAST_ADDR_LIST 

DL_H P_M U LTI CAST_L 1 ST_R E Q* 

RESET_STATI STICS 

DL_H P_R E S E T_ST AT S_R E Q* 

READ_STATISTICS 

DL_GET_STATI STI CS_REQ. This 
primitive returns mib and extended mib 
statistics for the device in one request. 

LOG_CONTROL 

Not required with DLPI. The control 
value (if any) is determined from the 
primitive. 

RESETINTERFACE 

DL_H P_H W_RESET_REQ* 

ENABLE_BROADCAST 

Not defined 

Dl SABLE_BROADCAST 

Not defined 

ADD_M U LTI CAST 

DL_ENABMULTI_REQ 

DE L ETE_M U LTI CAST 

DL_DISABMULTI_REQ 


Chapter 1 


15 

























LLA to DLPI Migration 

Transmitting Data 


Transmitting Data 

LLA requires the user to log a destination address (LOG_DEST_ADDR) 
and a destination service access point (LOG_DSAP) prior to sending any 
data. 

DLPI requires the user to specify the destination address and 
destination service access point (dsap) as part of the data transfer 
request. The combination of destination MAC address and dsap is 
referred to as the DLSAP address. 

TheDLSAP address format is basically the destination MAC address 
followed bytheLLC protocol value. A complete description of the DLSAP 
address format is described in the DLPI Programmer's Guide 

LLA supports the write system call for sending data requests. 

DLPI only supports the putmsg system call for sending data over RAW 
(seethe DLPI Programmer's Guide) and connectionless mode streams. 
The write system call is only supported over connection oriented 
streams in the DATA_XFER state (i.e. a connection must be established). 
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Receiving Data 

LLA does not automatically return LLC header information when 
packets are read by the user. The user is required to issue a separate 
control request (FRAM E_HEADER) to get the LLC header information 
for the last packet received. 

DLPI returns the LLC header information in the control portion of each 
individually received packet (i.e. DLJJNITDATAJ ND, DL_XI D_l ND, 
DL_TEST_IND, etc). The user is not required to issue a separate control 
request to get LLC header information. 

LLA only allows a maximum of 16 packets (for normal users and 64 for 
super users) to be queued before it starts dropping data. 

DLPI will read as many packets as possible until both the stream head 
read queue (default is about 10k bytes) and DLPI read queue (default is 
about 60K bytes) fill. When both these queues are full, DLPI will begin 
dropping data until the queues start draining. 
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LLA and DLPI Example 
Programs 


This chapter contains two example programs. 



LLA and DLPI Example Programs 


The first exampleshows a data transfer program using DLPI. The 
second example shows the same type of program using LLA for 
comparison. 
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LLA and DLPI Example Programs 

DLPI Example Program 


DLPI Example Program 

j■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-^-k-k-k-^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

(C) COPYRIGHT HEWLETT-PACKARD COMPANY 1992. ALL RIGHTS 
RESERVED. NO PART OF THIS PROGRAM MAY BE PHOTOCOPIED, 
REPRODUCED, OR TRANSLATED TO ANOTHER PROGRAM LANGUAGE WITHOUT 
THE PRIOR WRITTEN CONSENT OF HEWLETT PACKARD COMPANY 

-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k J 


J-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

The main part of this program is composed of two parts. 

The first part demonstrates data transfer over a connectionless 
stream with LLC SAP headers. The second part of this program 
demonstrates data transfer over a connectionless stream with 
LLC SNAP headers. 

•k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kj 


tinclude <stdio.h> 
tinclude <fcntl.h> 
tinclude <memory.h> 
tinclude <sys/types.h> 
tinclude <sys/stream.h> 
tinclude <sys/stropts.h> 
tinclude <sys/dlpi.h> 
tinclude <sys/dlpi_ext.h> 

tdefine SEND_SAP 0x80 /* sending SAP */ 

tdefine RECV_SAP 0x82 /* receiving SAP */ 

tdefine SNAP_SAP OxAA /* SNAP SAP */ 

j 'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

SNAP protocol values. 

k-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-kk-k-k-kk-kk-kk-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kf 

u_char SEND_SNAP_SAP[5] = {0x50, 0x00, 0x00, 0x00, 0x00}; 

u_char RECV_SNAP_SAP[5] = {0x60, 0x00, 0x00, 0x00, 0x00}; 

J 'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
global areas for sending and receiving messages 

' k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kj 

tdefine AREA_SIZE 5000 /* bytes; big enough for largest possible msg */ 

tdefine LONG_AREA_SIZE (AREA_SIZE / sizeof(u_long)) /* AREA_SIZE / 4 */ 

u_long ctrl_area[LONG_AREA_SIZE];/* for control messages */ 
u_long data_area[LONG_AREA_SIZE];/* for data messages */ 

struct strbuf ctrl_buf = { 

AREA_SIZE, /* maxlen = AREA_SIZE */ 

0, /* len gets filled in for each message */ 

ctrl_area /* buf = control area */ 

} ; 
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DLPI Example Program 


struct strbuf data_buf 
AREA_SIZ E, 

0 , 

data_area 

} ; 


{ 

/* maxlen = AREA_SIZE */ 

/* len gets filled in for each message */ 
/* buf = data area */ 


/ 




get the next message from a stream; get_msg() returns one of the 
following defines 

**★*★*★***************★***************★*★*★★***★★**★*★*****★***★★**★*i 


tdefine GOT_CTRL 
#define GOT_DATA 
tdefine GOT_BOTH 


/* message has only a control part */ 

/* message has only a data part */ 

/* message has control and data parts */ 


int 

get_msg(fd) 


int 

fd; 

/* 

file descriptor */ 

int 

flags = 0; 

/* 

0 -> get any available message */ 

int 

result = 0; 

/* 

return value */ 

/* 





zero first byte of control area so the caller can call check_ctrl 
without checking the get_msg return value; if only data was 
in the message and the user was expecting control or control + 
data, then when he calls check_ctrl it will compare the expected 
primitive zero and print information about the primitive 
that it got. 

*/ 

ctrl_area[0] = 0; 


/* call getmsg and check for an error */ 
if(getmsg(fd, &ctrl_buf, &data_buf, Sflags) < 0) { 

printf("error: getmsg failed, errno = %d\n", errno); 
exit(1) ; 


if (ctrl_buf.len > 0) { 

result [= GOT_CTRL; 


if(data_buf.len > 0) { 

result [= GOT_DATA; 


return (result); 


check that control message is the expected message 

void 


check_ctrl(ex prim) 

int ex_prim; 


{ 


/* the expected primitive */ 


dl_error_ack_t*err_ack = (dl_error_ack_t *)ctrl_area; 


/* did we get the expected primitive? */ 
if(err_ack->dl_primitive != ex_prim) { 
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/* 

if 


did we get a control part */ 

(ctrl_buf.len) { 

/* yup; is it an ERROR_ACK? */ 
if(err_ack->dl_primitive == DL_ERROR_ACK) { 

/* yup; format the ERROR_ACK info */ 
printf("error: expected primitive 

0x%02x, ", ex prim); 

printf ("got DL_ERROR_ACK\n"); 
printf(" dl_error_primitive = 

0x%02x\n", err_ack-> 
dl_error_primitive); 
printf(" dl_errno = 0x%02x\n", 

err_ack->dl_errno); 
printf(" dl_unix_errno = %d\n", 

err_ack->dl_unix_errno) 


exit (1) ; 


} else 


/* 

didn't get an ERROR_ACK either; print 
whatever primitive we did get 
*/ 

printf ("error: expected primitive 

0x%02x, ", ex_prim); 

printf ("got primitive 0x%02x\n", 

err_ack->dl_primitive) 


exit (1) ; 


} else 


{ 

/* no control; did we get data? */ 
if(data_buf.len) { 

/* tell user we only got data */ 
printf("error: check_ctrl found 
data\n"); 

exit (1) ; 


} else { 

/* 


only 


no message???; well, it was probably an 
interrupted system call 
*/ 

printf ("error: check_ctrl found no 
message\n"); 


exit (1) ; 


put a message consisting of only a data part on a stream 


void 

put_data(fd, length) 

int fd; /* file descriptor */ 

int length; /* length of data message */ 


{ 


/* set the len field in the strbuf structure */ 
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data_buf.len = length; 

/* call putmsg and check for an error */ 
if(putmsg(fd, 0, &data_buf, 0) < 0) { 

printf ("error: put_data putmsg failed, errno = %d\n", errno) 
exit(1); 


put a message consisting of only a control part on a stream 

void 

put_ctrl(fd, length, pri) 


int 

fd; 

/* 

file descriptor */ 

int 

length; 

/* 

length of control message */ 

int 

pri; 

/* 

priority of message: either 0 or RS_HIPRI */ 

/ * set 

the len field 

in 

the strbuf structure */ 


ctrl_buf.len = length; 


/* call putmsg and check for an error */ 
if(putmsg(fd, &ctrl_buf, 0, pri) < 0) { 

printf("error: put_ctrl putmsg failed, 
errno); 


exit (1) ; 


errno 


od\n", 


put a message consisting of both a control part and a control 
part on a stream 


void 

put_both(fd, ctrl_length, data_length, pri) 


int 

fd; 

/* 

file descriptor */ 

int 

ctrl_length; 

/* 

length of control part */ 

int 

data_length; 

/* 

length of data part */ 

int 

pri; 

/* 

priority of message: either 0 


or RS_HIPRI */ 


/* set the len fields in the strbuf structures */ 
ctrl_buf.len = ctrl_length; 
data_buf.len = data_length; 


/* call putmsg and check for an error */ 
if(putmsg(fd, &ctrl_buf, &data_buf, pri) < 0) { 

printf("error: put_both putmsg failed, errno 
errno); 

exit (1) ; 


od\n", 


j ■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

open the DLPI cloneable device file, get a list of available 
PPAs, and attach to the first PPA; returns a file descriptor 
for the stream 

*********************************************************************/ 
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int 

attach () 


{ 

int fd; 

int ppa; 

dl_hp_ppa_req_t 
dl_hp_ppa_ack_t 
dl_hp_pp a_in fo_t 
dl_attach_req_t 
char *mac_name; 


/* file descriptor */ 

/* PPA to attach to */ 

*ppa_req = (dl_attach_req_t *)ctrl_area; 
*ppa_ack = (dl_hp_ppa_ack_t *)ctrl_area; 
*ppa_info; 

*attach_req = (dl_attach_req_t *)ctrl_area; 


/* open the device file */ 

if((fd = open("/dev/dlpi", 0_RDWR)) == -1) { 

printf("error: open failed, errno = %d\n", errno) ; 
exit(1) ; 

} 


/* 

find a PPA to attach to; we assume that the first PPA on the 
remote is on the same media as the first local PPA 
*/ 

/* send a PPA_REQ and wait for the PPA_ACK */ 
ppa_req->dl_primitive = DL_HP_PPA_REQ; 
put_ctrl(fd, sizeof(dl_hp_ppa_req_t), 0); 
get_msg(fd); 

check_ctrl(DL_HP_PPA_ACK); 

/* make sure we found at least one PPA */ 
if(ppa_ack->dl_length == 0) { 

printf("error: no PPAs available\n"); 
exit(1); 

} 

/* examine the first PPA */ 

ppa_info = (dl_hp_ppa_info_t *)((u_char *)ctrl_area + 
ppa_ack->dl_offset) ; 
ppa = ppa_info->dl_ppa; 
switch(ppa_info->dl_mac_type) { 
case DL_CSMACD: 
case DL_ETHER: 

mac_name = "Ethernet"; 
break; 

case DL_TPR: 

mac_name = "Token Ring"; 
break; 

case DL_FDDI: 

mac_name = "FDDI"; 
break; 

default: 

printf("error: unknown MAC type in ppa_info\n"); 
exit(1); 

} 

printf("attaching to %s media on PPA %d\n", mac_name, ppa); 

/* 

fill in ATTACH_REQ with the PPA we found, send the ATTACH_REQ, 
and wait for the OK_ACK 
*/ 

attach_req->dl_primitive = DL_ATTACH_REQ; 
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attach_req->dl_ppa = ppa; 

put_ctrl(fd, sizeof(dl_attach_req_t), 0); 
get_msg(fd) ; 
check_ctrl(DL_OK_ACK); 

/* return the file descriptor for the stream to the caller */ 
return(fd); 

} 

/********************************************************************* 
bind to a sap with a specified service mode and max_conind; 
returns the local DLSAP and its length 

*********************************************************************j 

void 

bind(fd, sap, max_conind, service_mode, dlsap, dlsap_len) 
intfd;/* file descriptor */ 
intsap;/* 802.2 SAP to bind on */ 

intmax_conind;/* max # connect indications to accept */ 
intservice_mode;/* either DL_CODLS or DL_CLDLS */ 
u_char*dlsap;/* return DLSAP */ 
int*dlsap_len;/* return length of dlsap */ 

{ 

dl bind req t* bind_req = (dl_bind_req_t *)ctrl_area; 
dl_bind_ack_t* bind_ack = (dl_bind_ack_t *)ctrl_area; 
u_char* dlsap_addr; 

/* fill in the BIND_REQ */ 
bind req->dl primitive = DL_BIND_REQ; 
bind_req->dl_sap = sap; 
bind_req->dl_max_conind = max_conind; 
bind_req->dl_service_mode = service_mode; 

bind_req->dl_conn_mgmt = 0;/* conn_mgmt is NOT supported */ 

bind_req->dl_xidtest_flg = 0; /* user handles TEST/XID pkts */ 

/* send the BIND_REQ and wait for the OK_ACK */ 
put_ctrl(fd, sizeof(dl_bind_req_t), 0); 
get_msg(fd); 

check_ctrl(DL_BIND_ACK); 

/* return the DLSAP to the caller */ 

*dlsap_len = bind_ack->dl_addr_length; 

dlsap_addr = (u_char *)ctrl_area + bind_ack->dl_addr_offset; 
memcpy(dlsap, dlsap_addr, *dlsap_len); 

} 

J********************************************************************* 

bind to a SNAP sap via the DL_PEER_BIND, or DL_HIERARCHICAL_BIND 
subsequent bind class; returns the local DLSAP and its length 

*********************************************************************j 

void 

subs_bind(fd, snapsap, snapsap_len, subs_bind_class, dlsap, dlsap_len) 

int fd; 

u_char* snapsap; 

int subs_bind_class; 

u_char *dlsap; 

int *dlsap_len; 

{ 
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dl_subs_bind_req_t *subs_bind_req = (dl_subs_bind_req_t*)ctrl_area; 
dl_subs_bind_ack_t *subs_bind_ack = (dl_subs_bind_ack_t*)ctrl_area; 
u_char *dlsap_addr; 

/* Fill in Subsequent bind req */ 
subs_bind_req->dl_primitive = DL_SUBS_BIND_REQ; 
subs_bind_req->dl_subs_sap_offset = DL_SUBS_BIND_REQ_SIZE; 
subs_bind_req->dl_subs_sap_length = snapsap_len; 
subs_bind_req->dl_subs_bind_class = subs_bind_class; 
memcpy((caddr_t)&subs_bind_req[1], snapsap, snapsap_len); 

/* send the SUBS_BIND_REQ and wait for the OK_ACK */ 
put_ctrl(fd, sizeof(dl_subs_bind_req_t)+snapsap_len, 0); 
get_msg(fd); 

check_ctrl(DL_SUBS_BIND_ACK); 

/* return the DLSAP to the caller */ 

*dlsap_len = subs_bind_ack->dl_subs_sap_length; 

dlsap_addr = (u_char *)ctrl_area +subs_bind_ack->dl_subs_sap_offset 
memcpy(dlsap, dlsap_addr, *dlsap_len); 


}********************************************************************* 
unbind, detach, and close 


void 

cleanup(fd) 

int fd; /* file 


dl unbind req t*unbind req = 
dl_detach_req_t*detach_req = 


descriptor */ 

(dl unbind req t 
(dl_detach_req_t 


*)ctrl_area; 
*)ctrl_area; 


/* unbind */ 

unbind req->dl primitive = DL_UNBIND_REQ; 
put_ctrl(fd, sizeof(dl_unbind_req_t), 0); 
get_msg(fd); 
check_ctrl(DL_OK_ACK); 


/* detach */ 

detach req->dl primitive = DL_DETACH_REQ; 
put_ctrl(fd, sizeof(dl_detach_req_t), 0); 
get_msg(fd); 
check_ctrl(DL_OK_ACK) ; 


/* close */ 
close(fd); 


receive a data packet; 


int 

recv_data(fd) 

int fd; 


{ 


dl_unitdata. 


ind. 


t 


/* file descriptor */ 

*data_ind = (dl_unitdata_ind_t 


*)ctrl_area; 


Chapter 2 


27 



LLA and DLPI Example Programs 

DLPI Example Program 


char *rdlsap; 
int msg_res; 

msg_res = get_msg(fd); 
check_ctrl(DL_UNITDATA_IND); 
if(msg_res != GOT_BOTH) { 

printf ("error: did not receive data part of message\n"); 
exit (1) ; 

} 

return(data_buf.len); 


/****************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

send a data packet; assumes data_area has already been filled in 

********************************************************************* I 

void 

send_data(fd, rdlsap, rdlsap_len, len) 

int fd; /* file descriptor */ 

u_char* rdlsap;/* remote dlsap */ 

int rdlsap_len;/* length of rdlsap */ 

int len;/* length of the packet to send */ 

{ 

dl_unitdata_req_t *data_req = (dl_unitdata_req_t *)ctrl_area; 
u_cha r * out_dls ap; 


/* fill in data_req */ 

data_req->dl_primitive = DL_UNITDATA_REQ; 
data_req->dl_dest_addr_length = rdlsap_len; 
data_req->dl_dest_addr_offset = sizeof(dl_unitdata_req_t); 

/* copy dlsap */ 

out_dlsap = (u_char *)ctrl_area + sizeof(dl_unitdata_req_t); 
memcpy(out_dlsap, rdlsap, rdlsap_len); 

put_both(fd, sizeof(dl_unitdata_req_t) + rdlsap_len, len, 0); 


print a string followed by a DLSAP 

void 

print_dlsap(string, dlsap, dlsap_len) 

char *string; /* label */ 

u_char *dlsap; /* the DLSAP */ 

int dlsap_len; /* length of dlsap */ 

{ 

int i; 

printf ("%s", string); 
for(i =0; i < dlsap_len; i++) { 

printf("%02x", dlsap[i]); 


printf ("\n"); 

} 
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main 


main () { 

int send_fd, recv_fd; 

u_char sdlsap[20]; 
u_char rdlsap[20]; 
int sdlsap_len, rdlsap_len; 

int i, j, recv_len; 


/* file descriptors */ 
/* sending DLSAP */ 

/* receiving DLSAP */ 
/* DLSAP lengths */ 


/* 

PART 1 of program. Demonstrate connectionless data 
transfer with LLC SAP header. 

*/ 


/* 

First, we must open the DLPI device file, /dev/dlpi, and attach 
to a PPA. attach () will open /dev/dlpi, find the first PPA 
with the DL_HP_PPA_INFO primitive, and attach to that PPA. 
attach () returns the file descriptor for the stream. Here we 
do an attach for each file descriptor. 

*/ 

send_fd = attach(); 
recv_fd = attach(); 

/* 

Now we have to bind to a IEEESAP. We will ask for connectionless 
data link service with the DL_CLDLS service mode. Since we are 
connectionless, we will not have any incoming connections so we 
set max_conind to 0. bind() will return our local DLSAP and its 
length in the last two arguments we pass to it. 

*/ 

bind(send_fd, SEND_SAP, 0, DL_CLDLS, sdlsap, &sdlsap_len); 
bind(recv_fd, RECV_SAP, 0, DL_CLDLS, rdlsap, &rdlsap_len); 

/* print the DLSAPs we got back from the binds */ 
print_dlsap("sending DLSAP = ", sdlsap, sdlsap_len); 
print_dlsap("receiving DLSAP = ", rdlsap, rdlsap_len); 

/* 

Time to send some data. We'll send 5 data packets in sequence. 

*/ 

for(i =0; i < 5; i++) { 

/* send (i+l)*10 data bytes with the first byte = i */ 
data_area[0] = i; 

/* Initialize data area */ 
for (j =1; j < (i+1)*10; j++) 

data_area[j] = "a"; 

print_dlsap("sending data to ",rdlsap, rdlsap_len); 
send_data(send_fd, rdlsap, rdlsap_len, (i+1) * 10); 

/* receive the data packet */ 
recv_len = recv_data(recv_fd); 

printf("received %d bytes, first word = %d\n", recv_len, 
(u_int)data_area[0]); 
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/* 

We're finished with PART 1, Now call cleanup to unbind, then 
detach, then close the device file. 

*/ 

cleanup(send_fd); 
cleanup(recv_fd) ; 

/* 

PART 2 of program. Demonstrate connectionless data transfer 
with LLC SNAP SAP header. 

*/ 

/* 

As demonstrated in the first part of this program we must first 
open the DLPI device file, /dev/dlpi, and attach to a PPA. 

*/ 

send_fd = attach(); 
recv_fd = attach(); 

/* 

The first method for binding a SNAP protocol value (which is 
demonstrated below) requires the user to first bind the SNAP 
SAP OxAA, then issue a subsequent bind with class 
DL_HIERARCHICAL_BIND with the 5 bytes of SNAP information. 

The second method (which is not demonstrated in this program) is 
to bind any supported protocol value (see section 5) and then 
issue a subsequent bind with class DL_PEER_BIND. The data area 
area of the subsequent bind should include 6 bytes of data, the 
first byte being the SNAP SAP OxAA followed by 5 bytes of SNAP 
information. 

*/ 

bind(send_fd, SNAP_SAP, 0, DL_CLDLS, sdlsap, &sdlsap_len); 
bind(recv_fd, SNAP_SAP, 0, DL_CLDLS, rdlsap, &rdlsap_len); 

/* 

Now we must complete the binding of the SNAP protocol value 
with the subsequent bind request and a subsequent bind class 
of DL_HIERARCHICAL_BIND. 

*/ 

subs_bind(send_fd, SEND_SNAP_SAP, 5, D L_HIE RARCHICAL_BIND, 

sdlsap,&sdlsap_len); 

subs_bind(recv_fd, RECV_SNAP_SAP, 5, D L_HIE RARCHICAL_BIND, 

rdlsap,&rdlsap_len); 

/* print the DLSAPs we got back from the binds */ 
print_dlsap("sending DLSAP = ", sdlsap, sdlsap_len); 

print_dlsap("receiving DLSAP = ", rdlsap, rdlsap_len); 

/* 

Time to send some data. We'll send 5 data packets in sequence. 
*/ 

for(i =0; i < 5; it+) { 

/* send (i+l)*10 data bytes with the first byte = i */ 
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data_area[0] = i; 

/* Initialize data area */ 
for (j =1; j < (i+1)*10; j++) 

data_area[j] = "a"; 

print_dlsap("sending data to ",rdlsap, 
send_data(send_fd, rdlsap, rdlsap_len, 
/* receive the data packet */ 
recv_len = recv_data(recv_fd); 
printf("received %d bytes, first word 
data_area[0]); 


rdlsap_l 

(i + 1) 

= %d\n", recv_len, 


We're finished. Now call cleanup to unbind, then detach, 
then close the device file. 

*/ 

cleanup(send_fd); 
cleanup(recv_fd) ; 

} 
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LLA Example Program 

/*************************************************************************** 
(C) COPYRIGHT HEWLETT-PACKARD COMPANY 1992. ALL RIGHTS 
RESERVED. NO PART OF THIS PROGRAM MAY BE PHOTOCOPIED, 

REPRODUCED, OR TRANSLATED TO ANOTHER PROGRAM LANGUAGE WITHOUT 
THE PRIOR WRITTEN CONSENT OF HEWLETT PACKARD COMPANY 
***************************************************************************/ 


/***************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

The main part of this program is composed of two parts. 

The first part demonstrates data transfer over LLA 
with LLC SAP headers. The second part of this program 
demonstrates data transfer over LLA with LLC SNAP headers. 
**************************************************************************/ 


tinclude 

tinclude 

tinclude 

tinclude 

tinclude 

tinclude 


<stdio.h> 

<fcntl.h> 
<memory.h> 
<errno.h> 
<sys/types.h> 
<sys/netio.h> 


tdefine 

SEND_ 

_SAP 

0x80 

tdefine 

RECV_ 

_SAP 

0x82 

tdefine 

SNAP_ 

_SAP 

OxAA 


/* sending SAP */ 

/* receiving SAP */ 
/* SNAP SAP */ 


SNAP protocol values. 

u_char SEND_SNAP_SAP[5] = {0x50, 0x00, 0x00, 0x00, 0x00}; 
u_char RECV_SNAP_SAP[5] = {0x60, 0x00, 0x00, 0x00, 0x00}; 






global areas for sending and receiving messages 
**************************************************************************/ 
tdefine MAX_PKT_SIZE 1500 /* Maximum packet size for Ethernet */ 


u_long data_area[MAX_PKT_SIZE]; /* for data messages */ 

struct fis ctrl_buf; 


Read a packet on LLA file descriptor fd. 


int 

get_pkt(fd) 
int 


{ 


int 


fd; 

recv_cnt; 


/* file descriptor */ 
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/* 

* Read a packet from the device. 

*/ 

/* call read and check for an error */ 

if((recv_cnt = read(fd, data_area, MAX_PKT_SIZE)) < 0) { 

printf("error: read failed, errno = %d\n", errno); 
exit(1); 

} 

return(recv_cnt) ; 


Send a packet over LLA 

void 

put_data(fd, length) 

int fd; /* file descriptor */ 

int length; /* length of data message */ 

{ 


/* call putmsg and check for an error */ 
if(write(fd, data_area, length) < 0) { 

printf("error: put_data putmsg failed, errno = %d\n", errno); 
exit(1) ; 



/**********************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Send a control request to the driver. 

****************************************************************************/ 

void 

put_ctrl(fd, cmd) 

int fd; /* file descriptor */ 

int cmd; /* NETCTRL or NETSTAT */ 

{ 

/* Send control request to driver */ 
if(ioctl(fd, cmd, &ctrl_buf) < 0) { 

printf ("error: put_ctrl putmsg failed, errno = %d\n", errno); 
exit (1) ; 


/*********************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Open an LLA device. The device file specifies which device you 
attaching to. There is no need to issue a seperate attach control 
request to designate which device you are using. In this example 
we will default to /dev/lanO. 

*/ 

int 

attach () { 
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intfd; /* file descriptor */ 

char *mac_name; 


/* open the device file */ 

if((fd = open("/dev/lanO", 0_RDWR)) == -1) { 

printf("error: open failed, errno = %d\n", errno); 
exit (1) ; 

} 


/* return the file descriptor for the LLA device to the caller */ 
return(fd); 


Bind to a sap. LLA does not automatically return the local MAC 
address and local sap information when binding a protocol value. 
You must explicitly request the local MAC address via the 
LOCAL_ADDRESS control request. 


void 

bind(fd, sap) 

int fd; /* file descriptor */ 

int sap; /* 802.2 SAP to bind on */ 

{ 


ctrl_buf.reqtype 
ctrl_buf.vtype = 
ctrl_buf.value.i 


= LOG_SSAP; 
INTEGERTYPE; 
= sap; 


/* send the LOG_SSAP request. LLA will return success or 
failure when the ioctl completes, so there is no need to 
wait for an acknowledgement. 

*/ 

put_ctrl(fd, NETCTRL) ; 


/***************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Get the local MAC address. 

****************************************************************************/ 

void 

get_local_address(fd, ret_addr) 

int fd; /* file descriptor */ 

caddr_tret_addr;/* return local address here */ 

{ 

ctrl_buf.reqtype = LOCAL_ADDRESS; 

/* send the LOCAL_ADDRESS request. LLA will return success or 
failure when the ioctl completes, so there is no need to 
wait for an acknowledgement. 

*/ 

put_ctrl(fd, NETSTAT); 
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/* Copy the address to ret_addr */ 

memcpy(ret_addr, (caddr_t)ctrl_buf.value.s, 6); 


/*******************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Set the destination MAC and SAP address. 
****************************************************************************/ 
void 

set_dst_address(fd, dest_addr, dsap, length) 

int fd; /* file descriptor */ 

caddr_t dest_addr;/* return local address here */ 
int dsap;/* destination sap */ 

int length;/* destination sap length */ 


ctrl_buf.reqtype = LOG_DEST_ADDR; 
ctrl_buf.vtype = 6; 

memcpy((caddr_t)ctrl_buf.value.s, dest_addr, 6); 

/* send the LOG_DEST_ADDR request. LLA will return success or 
failure when the ioctl completes, so there is no need to 
wait for an acknowledgement. 

*/ 

put_ctrl(fd, NETCTRL); 

/* Only log sap addresses, SNAP addresses do not need to 
be logged twice. 

*/ 

if (length == INTEGERTYPE) { 

ctrl_buf.reqtype = LOG_DSAP; 
ctrl_buf.vtype = INTEGERTYPE; 
ctrl_buf.value.i = dsap; 
put_ctrl(fd, NETCTRL); 



/*********************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

bind to a SNAP sap. 

****************************************************************************/ 

void 

bind_snap(fd, snapsap) 
int fd; 

u_char *snapsap; 

{ 

/* Fill in SNAP req */ 

ctrl_buf.reqtype = LOG_SNAP_TYPE; 

ctrl_buf.vtype = 5; 

memcpy((caddr_t)ctrl_buf.value.s, snapsap, 5); 

/* send the SNAP request. */ 
put_ctrl(fd, NETCTRL); 

} 
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Close the file descriptor. This will automatically unbind the 
protocol. 

void 

cleanup(fd) 

int fd; /* file descriptor */ 


{ 


/* close */ 
close(fd); 


receive a data packet; 

int 

recv_data(fd) 

int fd; /* file descriptor */ 


{ 


int length; 


length = get_pkt(fd); 
if(length == 0) { 

printf("error: did not receive any data part \n") ; 
exit (1) ; 

} 

return(length); 


send a data packet; assumes data_area has already been filled in 
and a destination address has already been logged. 

void 

send_data(fd, len) 

int fd; /* 

int len; /* 


file descriptor */ 

length of the packet to send */ 


{ 


put_data(fd, 


len) ; 


print a string followed by a destination MAC and SAP address. 


void 

print_dest_addr 

char 

u_char 


string, dest_addr, dest_addr_len) 

*string; /* label */ 

*dest_addr; /* the destination address */ 
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int dest_addr_len; /* length of dest_addr */ 

{ 

int i; 

printf("%s", string); 

for(i =0; i < dest_addr_len; i+t) { 
printf ("%02x", dest_addr[i]); 

} 

printf("\n"); 

} 


/*********************-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

main 

****************************************************************************/ 
main () { 

int send_fd, recv_fd; /* file descriptors */ 

u_char local_addr[20]; /* local MAC address */ 

int i, j, recv_len; 

/* 

PART 1 of program. Demonstrate connectionless data transfer with 
LLC SAP header. 

*/ 

/* 

First, we must open the LLA device file, /dev/lanO. LLA does 
not require a seperate control request to specify which device 
you want to use, it is explicit in the open request (via the 
device file minor number). 

*/ 

send_fd = attach (); 
recv_fd = attach(); 

/* 

Now we have to bind to a IEEESAP. Since LLA only supports 
connectionless services there is no need to specify a specific 
service mode. LLA also does not return the local MAC address 
automatically when binding, so we need to issue a seperate control 
request (LOCAL_ADDRESS)to get this information (see below). 

*/ 

bind(send_fd, SEND_SAP); 
bind(recv_fd, RECV_SAP); 

/* 

The following calls to get_local_address and set_dst_address 
are required for LLA because of one primary difference in sending 
data over LLA and DLPI. The difference is that DLPI 
requires you to specify the destination address as part of the 
data request and LLA requires the destination address to be 
logged prior to the data request. 

Get the local MAC address so that we can send loopback packets. 

*/ 

get_local_address(send_fd, local_addr); 
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/* 

Set the destination MAC and SAP address to the local address. 
This will allow us to send loopback packets. 

*/ 

set_dst_address(send_fd, local_addr, RECV_SAP, INTEGERTYPE); 


/* print the MAC and SAP addresses we are sending and receiving on */ 
local_addr[6] = SEND_SAP; 

print_dest_addr("sending too = ", local_addr, 7); 
local_addr[6] = RECV_SAP; 

print_dest_addr("receiving on = ", local_addr, 7); 


/* 

Time to 
*/ 

for (i = 


send some data. We'll send 5 data packets in sequence. 
0; i < 5; it+) { 

/* send (i+l)*10 data bytes with the first byte = i */ 
data_area[0] = i; 

/* Initialize data area */ 
for (j =1; j < (i+1)*10; j++) 

data_area[j] = "a"; 

print_dest_addr("sending data to ",local_addr, 7); 
send_data(send_fd, (i+1) * 10); 

/* receive the data packet */ 
recv_len = recv_data(recv_fd); 

printf("received %d bytes, first word = %d\n", recv_len, 
(u_int)data_area[ 0 ] ) ; 


/* 

We're finished with PART 1. Now call cleanup to close the device file. 
*/ 

cleanup(send_fd); 
cleanup(recv_fd) ; 


/* 

PART 2 of program. Demonstrate connectionless data transfer with 
LLC SNAP SAP header. 

*/ 


/* 

As demonstrated in the first part of this program we must first 
open the DLPI device file, /dev/dlpi, and attach to a PPA. 

*/ 


send_fd = attach(); 
recv_fd = attach(); 

/* 

Bind the send and recv SNAP protocols. When binding SNAP over 
LLA the SNAP address will be used as both the sending and receiving 
protocol address. Therefore, there is no need to issue a seperate 
request to log the destination SNAP protocol. However, we still need 
to set the destination MAC address. 

*/ 

bind_snap(send_fd, SEND_SNAP_SAP); 
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/* 

The following bind is not needed because we are running in loopback 
mode with only one LAN interface. Since the sending LLA device 
will use the same SNAP address for sending and receiving we'll 
just loopback on the same LLA file descriptor. 
bind_snap(recv_fd, RECV_SNAP_SAP); 

*/ 

get_local_address(send_fd, local_addr); 

/* 

Set the destination MAC and SAP address to the local address. 

This will allow us to send loopback packets. As mention above, 
the SNAP address does not need to be logged, it is used here 
only to distinguish SAPs and SNAP values. 

*/ 

set_dst_address(send_fd, local_addr, RECV_SNAP_SAP, 6) ; 

/* print the MAC and SAP addresses we are sending and receiving on */ 
memcpy((caddr_t)&local_addr[6], SEND_SNAP_SAP, 5); 
print_dlsap("sending too = ", local_addr, 11); 
print_dlsap("receiving on = ", local_addr, 11); 

/* 

Time to send some data. We'll send 5 data packets in sequence. 

*/ 

for(i = 0; i < 5; i++) { 

/* send (i+l)*10 data bytes with the first byte = i */ 
data_area[0] = i; 

/* Initialize data area */ 
for (j = 1; j < (i + 1)* 10; j++) 

data_area[j] = "a"; 

print_dlsap("sending data to ",local_addr, 11); 

send_data(send_fd, (i + 1) * 10); 

/* receive the data packet. Since we are sending 
to the SNAP address we enabled on the send_fd we 
must also receive on this file descriptor. 

*/ 

recv_len = recv_data(send_fd); 

printf("received %d bytes, first word = %d\n", recv_len. 


/* 

We're finished. Now call cleanup to then close the device file. 
*/ 

cleanup(send_fd); 
cleanup(recv_fd) ; 
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